//----------------------------------------------------------------------------------------------//
//												//
//	What type of program is this?								//
//												//
//----------------------------------------------------------------------------------------------//

This program belongs to the type of indicators with trainable AI.
The built-in AI is trainable, i.e. without preliminary training it has no parameters and simply will not start.
If you received a limited demo version not through the MQL5.com store, then after downloading,
manually place the file in the "Indicators" folder of the terminal.


//----------------------------------------------------------------------------------------------//
//												//
//	What is it for?										//
//												//
//----------------------------------------------------------------------------------------------//

This indicator uses a trainable AI to predict future price behavior:

- 10 days ahead,
- 1.7 days ahead,
- 5 hours ahead,
- 50 minutes ahead,
- 10 minutes ahead.

Additional information is also provided here in the form of:
- the predicted price deviation in points and,
- the predicted error in percent (if this value exceeds 50%,
the program will issue a warning).

This program has a trainable AI built in, that is, before using it,
it must be trained on new input data.


//----------------------------------------------------------------------------------------------//
//												//
//	How do I get the input data file for training the corresponding neural networks?	//
//												//
//----------------------------------------------------------------------------------------------//

How to do this is described in the corresponding instructions using the "AI Learn Utility".
The AI learning utility is free and can be downloaded manually by you from
the main product page on the MQL5 website.


//----------------------------------------------------------------------------------------------//
//												//
//	Description of the menu options of this program.					//
//												//
//----------------------------------------------------------------------------------------------//

There are only two parameters here:

- 1) "Show Comment" - enables/disables display of comments in the window where this program is running.
This is necessary if you plan to use this indicator in your MQL5 program and then,
if necessary, this parameter can be disabled.
- 2) "Deviation" - enables/disables display of the predicted deviation of the predicted value
expressed in points.


//----------------------------------------------------------------------------------------------//
//												//
//	Testing the demo version of this program.						//
//												//
//----------------------------------------------------------------------------------------------//

Before testing, you need to train the built-in AI if this has not been done before.
The free demo version of this program, which works only in the strategy tester, is limited
so that the commentary on the predicted values will be displayed only until
the beginning of August 2025, so for free testing, use the time range
before this date.
Here, it is better to use the testing mode - "OHLC on M1" for acceleration, since the indicator
calculates its new values only at the moment of opening new candles.


//----------------------------------------------------------------------------------------------//
//												//
//	Using this indicator in your MQL5 program.						//
//												//
//----------------------------------------------------------------------------------------------//

This indicator has 3 value buffers that can be used:

a) "0 Buffer" - contains information about the predicted price, where there are only 5 values:

0) - 10 days ahead,
1) - 1.7 days ahead,
2) - 5 hours ahead,
3) - 50 minutes ahead,
4) - 10 minutes ahead.

b) "1 Buffer" - contains information about the predicted deviation
in the form - (deviation in points) * (the value of one price point),
where there are only 5 values:

0) - 10 days ahead,
1) - 1.7 days ahead,
2) - 5 hours ahead,
3) - 50 minutes ahead,
4) - 10 minutes ahead.

c) "2 Buffer" - contains information about the predicted error
in the form - (error in percent)/100, i.e. values from 0 to 1,
where there are only 5 values:

0) - 10 days ahead,
1) - 1.7 days ahead,
2) - 5 hours ahead,
3) - 50 minutes ahead,
4) - 10 minutes ahead.


//----------------------------------------------------------------------------------------------//
//												//
//	Features of using this program.								//
//												//
//----------------------------------------------------------------------------------------------//

Although the "AI Learn Utility" uses OpenCL and requires an appropriate device, the standalone indicator program itself performs all calculations on the CPU and does not need OpenCL support.

Minimum hardware requirements:

- 20 GB of free hard disk space,
- 4 GB of video card with OpenCL support,
- 16 GB of RAM.

ATTENTION: - The AI parameter files for each symbol take up approximately 1 GB.

This program uses many files with neural network parameters from the
folder "//Common//Files//SolarTradeSuite//Theia//...", so there are probably limitations on
working in the strategy tester and on VPS.

Testing strategies and optimization with this indicator can probably only be performed locally or
it is impossible to use a cluster of agents in a local network or
it is impossible to use a cloud network MQL5.

Testing strategies and optimizing advisors, as well as the
number of simultaneously running programs outside the strategy tester is also,
possibly limited by the number of simultaneously open files, which is approximately equal to
160 local agents and is described in detail in the MQL5 technical documentation.

The same limitations for VPS: This indicator has not been tested for the possibility of working in
VPS, due to the large number of files with AI parameters, it may not work.

Before starting, make sure that at least 108 candles of the "MN1" timeframe or 10 years are available from the moment
of starting this program. This is necessary because the built-in AI uses
price history for the last 9 years as input data to make a forecast.

Outside the strategy tester, this program can be run on any timeframe, i.e.
the timeframe of the window in which the program is launched outside the strategy tester does not matter.

When you first launch a previously unused symbol, you must first train the AI -
how to do this is described in the corresponding instructions using the "AI Learn Utility".
It is recommended to use the "AI Learn Utility" as often as possible, but
approximately no later than one or two years after the last use or
if a large period of time has passed since the last training,
or you observe significant changes in the price behavior of the symbol used.

Keep in mind: "!!! ATTENTION: This AI can make mistakes - be sure to check its forecasts for correctness!!!".
The error calculation and the forecast itself are made using methods of advanced mathematical,
statistical analysis and machine learning, but the price of a financial instrument can be affected by
other events not taken into account by such methods, such as political intentions, environmental events, weather conditions, etc.

All AI parameters are saved to the hard drive in the terminal folder "//Common//Files//SolarTradeSuite//Theia//... ". If you have a link to download ready-made parameters for AI, then after downloading, copy them there.

Do not forget to manually make a backup copy of the AI parameters in a separate folder that you created yourself.


//----------------------------------------------------------------------------------------------//
//												//
//	Additional questions.									//
//												//
//----------------------------------------------------------------------------------------------//

The AI training utility is free and can be downloaded manually by you from the
main product page on the MQL5 website.
All instructions are available and can be downloaded manually by you from the
main product page on the MQL5 website. Please read all instructions and the
license file carefully before asking any questions.

1) Please feel free to ask questions in the discussion tab on the corresponding indicator page on the MQL5.com website.

2) Email for communication: gerasimovadam@gmail.com , tgwls2@gmail.com .